src/cli/cmd-snippet.ts (1)

200-224: ⚡ Quick win

Add public API docs for renderSnippetTerminal.

This function is exported, so it should have a concise JSDoc describing its output contract.

Proposed diff

+/**
+ * Render snippet matches in terminal order: location header, signature, then source.
+ * Emits stderr hints for disambiguation and stale snippets.
+ */
 export function renderSnippetTerminal(result: SnippetResult): void {

As per coding guidelines: **/*.{ts,tsx,js,jsx}: All public APIs must have accompanying documentation.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/cli/cmd-snippet.ts` around lines 200 - 224, Add a concise JSDoc above the
exported function renderSnippetTerminal(SnippetResult) describing its public
API: explain that it prints snippet matches to stdout and
disambiguation/staleness messages to stderr, describe the output format
("file_path:line_start-line_end" followed by signature and optional source) and
side effects (prints blank line between matches, sets anyStale behavior), and
document the parameter type (SnippetResult) and that the function returns void;
include at least one short sentence about when stderr is used (disambiguation
and stale notices).